2019.3.5 Maintenance Release [2020-06-02]

Changelog Overview

• 3 Improvements
• 45 Bug Fixes
• 4 Chores
• 1 Deprecations
• 53 Total Tickets

Improvements

• app-golden_config:5.18.0-2019.3.2 [06-02-2020] - Ensured Indexes functionality is now called from the dependent pronghorn-utils module, reducing code duplication in the current app.
• app-service_management:2.23.3-2019.3.2 [05-15-2020] - Enhanced error dialog to show detailed NSO error messages if saveInstance call fails.
• itential-utils:2.2.19 [05-11-2020] - Removed drop indices clause. Instead the tool will now report unrecognized indices and inform the user to review them at their own discretion.

Bug Fixes

• adapter-nso:6.27.4-2019.3.18 [06-01-2020] - Error message is returned when required params are not provided.
• adapter-nso:6.27.4-2019.3.17 [05-28-2020] - Modified service instance related methods to handle service models with no key property.
• adapter-nso:6.27.4-2019.3.16 [05-28-2020] - Modified setConfig() to return dry run result as response when using nso5.x.
• adapter-nso:6.27.4-2019.3.15 [04-30-2020] - Added contentType param to doRESTAction API.
• adapter-nso:6.27.4-2019.3.14 [05-05-2020] - Restored key property to service model. Saveinstances is now able to accept incoming array of data.
• adapter-prospector:1.6.11-2019.3.3 [06-02-2020] - Removed peer dependencies.
• app-automation_catalog:2.4.2-2019.3.16 [06-01-2020] - * Updated an automation to prevent lost of user context data.
• Enhanced emulated user context to contain groups information for running automation after AC has been restarted.
• Fixed "Last Updated by" field to show username instead of user ID..
• app-automation_catalog:2.4.2-2019.3.15 [05-10-2020] - Fixed issues with navbar search not searching properly.
• app-automation_studio:1.0.0-2019.3.16 [05-15-2020] - The option to add groups and job description is now available when running an automation.
• app-automation_studio:1.0.0-2019.3.15 [05-04-2020] - Updated search function and Rodeo version to fix global search.
• app-configuration_manager:3.28.19-2019.3.34 [05-11-2020] - Created script to convert from maintenance version to enterprise version.
• app-configuration_manager:3.28.19-2019.3.33 [05-08-2020] - Updated schema documentation for getDeviceConfigFormat.
• app-configuration_manager:3.28.19-2019.3.32 [05-08-2020] - Removed unused pubsub-js library.
• app-configuration_manager:3.28.19-2019.3.31 [05-08-2020] - Removed unused react-icons library.
• app-configuration_manager:3.28.19-2019.3.30 [05-06-2020] - Fixed the empty drop-down that displays when searching.
• app-configuration_manager:3.28.19-2019.3.29 [05-06-2020] - Improved error logging for compliance failures.
• app-configuration_manager:3.28.19-2019.3.28 [05-05-2020] - Backups will now only show up for the specific device selected.
• app-configuration_manager:3.28.19-2019.3.28 [05-04-2020] - Updated navbar search to work.
• app-configuration_manager:3.28.19-2019.3.27 [05-04-2020] - Updated the getDeviceConfigFormat API description.
• app-form_builder:4.2.9-2019.3.11 [06-01-2020] - Design updates completed to improve visual consistency within the platform.
• app-json_forms:1.13.0-2019.3.20 [05-29-2020] - Renamed the showForm task input to form_name instead of form_id.
• app-json_forms:1.13.0-2019.3.19 [05-27-2020] - Enhanced the FormCanvas to support arrays as dropdown options.
• app-mop:6.3.6-2019.3.17 [06-02-2020] - Made design improvements for visual consistency across IAP.
• app-nso_manager:2.18.0-2019.3.5 [05-05-2020] - Added contentType parameter to restAction API documentation.
• app-nso_manager:2.18.0-2019.3.4 [04-30-2020] - Fixed schema errors.
• app-service_catalog:3.9.8-2019.3.3 [05-14-2020] - Fixed crash in Service Catalog when mongo adapter is not registered with persistence broker.
• app-service_management:2.23.3-2019.3.3 [05-29-2020] - Fixed errors when handling service models with no key property.
• app-template_builder:2.3.6-2019.3.5 [05-13-2020] - Modified the logging response for a deleteTemplate API.
• app-workflow_builder:5.5.9-2019.3.25 [05-26-2020] - Made improvements to bind task reference and reference variable to real values.
• app-workflow_builder:5.5.9-2019.3.24 [05-21-2020] - Updated grammar of error text upon workflow validation error condition.
• app-workflow_builder:5.5.9-2019.3.23 [06-02-2020] - Disabled save button in settings modal when no updates are available to be made.
• app-workflow_builder:5.5.9-2019.3.22 [05-19-2020] - Fixed actor validation in import method.
• app-workflow_builder:5.5.9-2019.3.21 [05-13-2020] - Fixed issues with childJob task child workflow search.
• app-workflow_engine:6.7.10-2019.3.47 [05-28-2020] - Fixed bug causing non-static variables to be incorrectly altered when migrating workflows from 2019.2 and previous.
• app-workflow_engine:6.7.10-2019.3.46 [05-26-2020] - Fixed incorrect sorting of iteration tasks.
• app-workflow_engine:6.7.10-2019.3.45 [05-19-2020] - Added validation error when job variable includes a '.' or '$' character.
• app-workflow_engine:6.7.10-2019.3.44 [05-15-2020] - When task is running or in a scheduled state, jobs will no longer error when updates are made. Errors will be logged instead.
• app-workflow_engine:6.7.10-2019.3.43 [05-08-2020] - Fixed bug that caused canceling child jobs to always error.
• itential-utils:2.2.20 [05-13-2020] - Updated the itential-utils library package.json file to support NodeJS v8 and v10.
• itential-utils:2.2.18 [05-13-2020] - Bumping the version to fix an issue encountered when publishing the package.
• itential_tools:1.23.11-2019.3.4 [06-03-2020] - Corrected STAROS show config command.
• itential_tools:1.23.11-2019.3.3 [06-03-2020] - Enabled Golden Config app to render config properly when multiple NEDs of the same type are installed in one NSO.
• pronghorn-core:10.12.21-2019.3.49 [05-29-2020] - Added authorization check to Pronghorn Sudo method to enable successful authentication. User is notified when a call to a particular method in IAP is not allowed.
• pronghorn-core:10.12.21-2019.3.48 [05-26-2020] - Updated ampqlib dependency to support NodeJS v10.
• tags:2.2.3-2019.3.5 [05-26-2020] - Tags app will no longer limit ref_id length to minimum 3 characters. Instead, any length over 0 will be accepted as valid ref_id.

Chores

• itential-utils:2.2.21 [05-21-2020] - Updated node driver for MongoDB.
• pronghorn-core:10.12.21-2019.3.47 [05-20-2020] - Improved error message when the input or output of an API call does not match the expected schema.
• pronghorn-core:10.12.21-2019.3.46 [05-20-2020] - Removed redundant encrypted source files from the pronghorn utils/ location.
• pronghorn-core:10.12.21-2019.3.45 [05-12-2020] - Updated the inquirer dependency to new version to normalize dependency versions across the platform.

Deprecations

• pronghorn-core:10.12.21-2019.3.44 [05-13-2020] - Removed broken function locateService from the Service broker.

2019.3.5 Release Versions

Automation Platform Versions

component	version
@itential/adapter-automation_gateway	2.12.0-2019.3.6
@itential/adapter-azure_aaa	1.0.8-2019.3.1
@itential/adapter-email	3.1.5-2019.3.1
@itential/adapter-ldap	2.12.6-2019.3.1
@itential/adapter-local_aaa	3.0.3-2019.3.0
@itential/adapter-mongo	2.9.0-2019.3.1
@itential/adapter-nso	6.27.4-2019.3.18
@itential/adapter-policy_engine	1.0.7-2019.3.1
@itential/adapter-prospector	1.6.11-2019.3.3
@itential/adapter-radius	2.0.3-2019.3.0
@itential/adapter-redis	2.0.7-2019.3.0
@itential/app-automation_catalog	2.4.2-2019.3.16
@itential/app-automation_studio	1.0.0-2019.3.16
@itential/app-configuration_manager	3.28.19-2019.3.34
@itential/app-form_builder	4.2.9-2019.3.11
@itential/app-golden_config	5.18.0-2019.3.2
@itential/app-golden_services	1.3.6-2019.3.2
@itential/app-json_forms	1.13.0-2019.3.20
@itential/app-mop	6.3.6-2019.3.17
@itential/app-nso_manager	2.18.0-2019.3.5
@itential/app-policy_manager	3.28.29-2019.3.19
@itential/app-service_catalog	3.9.8-2019.3.3
@itential/app-service_management	2.23.3-2019.3.3
@itential/app-smart_template	1.8.0-2019.3.6
@itential/app-task_worker	3.0.11-2019.3.5
@itential/app-template_builder	2.3.6-2019.3.5
@itential/app-workflow_builder	5.5.9-2019.3.25
@itential/app-workflow_engine	6.7.10-2019.3.47
@itential/pronghorn-core	10.12.21-2019.3.49
@itential/search	1.1.3-2019.3.0
@itential/tags	2.2.3-2019.3.5
@itential/itential-utils	2.2.21

Automation Gateway Versions

component	version
automation_gateway	2.36.3-2019.3.29

NSO Manager Versions

component	version
itential_tools	1.23.11-2019.3.4
prospector	1.10.4-2019.3.0

Engine Versions

component	version
policy-engine	1.9.2-2019.3.0

Dependencies

Automation Platform Server

package	supported versions	recommended version
nodejs	10.x	10.20.1

The gcc-c++ and make packages should be installed from your OS distribution.

Template Builder

package	supported	recommended
python	2.x or 3.x	3.8.2

pip	supported	recommended
pip	any version	20.0.2
textfsm	0.x or 1.x	1.1.0
Jinja2	2.x	2.11.1

Mongo Server

package	supported	recommended
mongodb	3.6.x	3.6.16

RabbitMQ Server

package	supported	recommended
rabbitmq	3.8.x	3.8.3
erlang	21.3+ or 22.x	22.3

Redis Server

package	supported	recommended
redis	5.x	5.0.8

The gcc-c++ and make packages should be installed from your OS distribution.

Automation Gateway

package	supported	recommended
python	3.6	3.6.10
openssl	1.x	1.1.1e
haproxy	2.x	2.1.3

The gcc-c++ and make packages should be installed from your OS distribution.

The following development packages are required to install automation gateway: libffi-dev, openssl-dev, python-dev, sqlite-dev.

pip package	supported	recommended
pip	any version	20.0.2
ansible	2.7, 2.8 or 2.9	2.9.7

One or more of the following packages may be required by the specific ansible modules you're using: psutil, pycrypto, paramiko, ncclient, lxml, nitrosdk-python, jxmlease.

Check the ansible documentation for the roles you're planning to use for additional package requirements.

Prospector

package	supported	recommended
java	1.7 or 1.8	1.8.242.08

NSO/Itential Tools

package	supported	recommended
java	1.7 or 1.8	1.8.242.08

The ant package should be installed from your OS distribution.

IAP Compatibility

Device Configuration

Device Configuration compatibility describes which devices are expected to work with the basic features of the Configuration Manager application across various southbound systems.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

Refer to the NSO Versions and NED Versions tables below for a list of tested devices.

Device Compliance

Device Compliance compatibility describes which devices are expected to work with Golden Configurations.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO (Configuration Manager app):

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO (Golden Config app):

* a10-acos
* adtran-aos
* alu-sr
* arista-dcs
* cisco-ios
* cisco-iosxr
* cisco-nx
* cisco-staros
* f5-bigip
* huawei-vrp
* juniper-junos

Device Maintenance

Device Maintenance compatibility describes which devices Itential can perform maintenance activities on (e.g., reboots and firmware upgrades).

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Juniper Junos

NSO:

* cisco-ios
* cisco-iosxr
* juniper-junos

Device Health Checks

Device Health Checks compatibility describes which devices Itential can execute read-only show commands to use the method broker and Command Templates application.

Ansible:

* Arista EOS
* Cisco IOS
* Cisco IOSXR
* Cisco NX
* Juniper Junos

NSO:

* a10-acos
* alu-sr
* arista-dcs
* cienacli-acos
* cisco-aireos
* cisco-asa
* cisco-gss
* cisco-ios
* cisco-iosxr
* cisco-nx
* cisco-qps
* cisco-staros
* ericsson-sgsnmme
* f5-bigip
* huawei-vrp
* juniper-junos

Note: Some of the devices in the health checks category are tested against netsim devices.

Forms

Ansible:

IAP can render most ansible networking modules as forms. Support for specific modules may vary. If you encounter issues with any particular modules, reach out to the Itential Product Support Team for assistance.

NSO:

IAP can render most service models advertised by NSO as forms. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Product Support Team for assistance.

Service Provisioning

NSO:

IAP can provision most service models advertised by NSO. Support for specific yang features may vary. If you encounter issues with your service models, reach out to the Itential Product Support Team for assistance.

Devices/Services Compatibility

The Itential Automation Platform is tested against the following component versions.

Ansible Versions:

* 2.7.17
* 2.8.11
* 2.9.7

Ansible Modules:

* eos_facts
* eos_command
* eos_config
* ios_facts
* ios_command
* ios_config
* iosxr_facts
* iosxr_command
* iosxr_config
* nx_facts
* nx_command
* nx_config
* junos_facts
* junos_command
* junos_config

NSO Versions:

* 5.2.2.1
* 4.7.7
* 4.6.5

NSO NED Versions:

ned	4.6.5	4.7.7	5.2.2.1
a10-acos	3.15.3	3.16.1	3.16.1 3.16
adtran-aos	4.0.5	4.0.5	4.0.5
alu-sr	8.3	8.6.1	8.6.1 8.6
arista-dcs	5.7	5.10.2	5.10.2 5.10.1
checkpoint-gaiaos_rest	1.3.8	1.3.10	1.8.8 1.8.7
ciena-acos	6.1.5	6.1.5	6.1.5
cisco-aireos	3.3.20	3.3.18	3.3.20
cisco-asa	6.7.7	6.8.7	6.8.7 6.8.6
cisco-gss	2.1.1	2.1.1	2.1.1
cisco-ios	6.42.2	6.48	6.48 6.47
cisco-iosxr	7.18.2	7.23.1	7.23.1 7.23
cisco-nx	5.1.3	5.15.5	5.15.5 5.15.4
cisco-qps	5.1.2	5.1.0	5.1.3 5.1.2
cisco-staros	5.22.1	5.24.1	5.24.1 5.24
ericsson-sgsnmme	1.0.7	1.0.7	1.0.7
f5-bigip	3.7.13	3.9.3	3.9.3 3.9.2
fortinet-fortios	5.4	5.4.5	5.4.5 5.4.4
huawei-usn	1.2.1	1.2.1	1.2.1
huawei-vrp	6.1	6.3.9	6.3.9 6.3.8
juniper-junos	4.5.17	4.5.23	4.5.23 4.5.22
paloalto-panos_cli	4.3.1	4.0.1	4.3.5 4.3.4
radware-alteonos	2.4	2.4	2.4
unix-bind	2.0.17	2.1.0	2.1.0 2.0.17

VTS Versions:

* 2.6.2

VTS NED Versions:

ned	2.6.2
cisco-iosxr	6.6
cisco-ncs5500	1.0
cisco-nx	5.1.4

Virtual Devices:

* A10 vThunder 4.1.4 GR1
* Arista EOS-4.23.0FX
* Checkpoint R80.30-273.583
* Cisco ASAv 9.13.1.7
* Cisco CSR 16.12.1a
* Cisco NX 9.3.2, 9.3.1
* Cisco StarOS 21.15.29
* Cisco XR6.3.1
* F5 BIGIP 15.1.0.2-0.0.9
* Fortigate 6.4.0
* Juniper VMX 18.4R1
* Juniper VSRX 19.1R2
* PanOS 9.1.2
* Radware 32.6.0.0

IAP Browser Compatibility

This maintenance release was tested against the following browser versions:

* Firefox 69.0
* Chrome 76.3809.87
* Edge 44.18362.1.0
* IE11 11.678.17763